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How to setup a USB 3G Modem on Raspberry PI using 
usb_modeswitch and wvdial 

Submitted by The Fan Club on Tue, 2013-11-12 16:04 

Setting up a USB 3G/4G modem on a Raspberry Pi is not a simple task. There are many guides available using the 
now defunct sakisSg script, but getting my modem to work required a bit more understanding. 

The main problem is that most USB modems act as two devices - a USB storage device and a USB modem. When 
plugged in to the Raspberry PI the device is usually in USB storage mode. There is a program called 
usb_modeswitch that we can use to do the switching 

The other missing part is a way to connect to the cellular network with the USB modem from the Raspberry. For this 
we will use the classic ppp and wvdial programs. 

Requirements 

• Raspberry PI computer 

• Raspbian OS installed 

• USB 3G Modem 

• 5V 1 A power supply for the Raspberry PI 



1. Install required software 

• Connect your Raspberry PI to the internet via LAN or Wifi 

• Open a terminal window and enter: 

sudo apt-get update 

sudo apt-get install ppp usb-modeswitch 
wvdial 

2. Get the USB switching codes 

• We need to get the codes of the USB device in USB storage mode and USB modem mode. 

• Connect your USB modem and reboot the Raspberry PI without LAN or Wifi connection 

• Once rebooted open a terminal window and enter: 

Isusb 

• The output will look similar to the screenshot below. Your modem should be listed as one of the USB devices. 
Note the numbers underlined. These are the device vendor and product codes. 
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Linux Foundation 2.0 root hub 
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Linux Foundation 1.1 root hub 
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ZTE WCDMA Technologies MSM MF627/MF628/MF628+/MF636+ HSDPA/HSUPA 
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Logitech, Inc. Cordless Desktop S510 



• Make a note of these numbers. In this case it is 19d2:2000 

• This value will later be used in the DefaultProduct value 

• Then we need to soft reboot the Rapberry PI with the modem connected. 

• Open a terminal window and enter: 

sudo 
reboot 

• Once rebooted open a terminal window and enter: 

Isusb 

• The output will look similar to the screenshot below. Your modem should be listed and if you are lucky the 
second set of numbers would have changed. This is usb_modeswitch doing it's job and switching the device to 
USB modem mode. 



Bus 001 Device 002: ID 0424:2514 Standard Microsystems Corp. USB 2.0 Hub 

Bus 001 Device 003: ID 0bda:0136 Realtek Semiconductor Corp. 

Bus 001 Device 001: ID ld6b:OO02 Linux Foundation 2.0 root hub 

Bus 002 Device 001: ID ld6b:0001 Linux Foundation 1.1 root hub 

Bus 001 Device 008: ID 19d2:2O02 ZTE WCDMA Technologies MSM 

Bus 001 Device 004: ID 046d:c50c Logitech, Inc. Cordless Desktop S510 



• Make a note of the new numbers. In this case it is 19d2:2002 

• This value will be used later in the TargetProduct value 

3. Create custom usb_modeswitch config file 

• We need to create a custom config file for usb_modeswitch on the Raspberry PI because on a cold boot the 
device is not always active yet when usb_modeswitch runs on startup and the device is left in USB storage 
mode. 

• We will extract some more information for our usb_modeswitch config file so that we can do the switching 
manually. 

• Open a terminal window and enter the following replacing the codes 19d2 and 2000 with the codes you noted 
in step 2. Also note the added backslash. 



cd /tmp 

tar -xzvf /usr/share/usb_modeswitch/conf igPack . tar . gz 
19d2\:2000 



Now open the extracted file with a text editor like leafpad replacing the codes noted in step 2. 



leafpad 19d2 :2000 



• The content of the file should look something similar to the screenshot below. 

• The parts we are interested in are shown in blue. 

# ZTE devices 
TargetVendor= exl9d2 

TargetProductList= "0001,6682, eei5, 6016, eei7, 6631, 6637, 6652, 0655, 6663, 6664, 0066, 6091, 0168, 6117, 6128, 6157, 2662, 2663" 

MessageContent=" 55534243123456786000000000000616000000000000000000000000000000" 
MessageContent2=" 55534243123456790000000000000616000000020000000000000000000000" 
MessageContent3="55534243123456762e00O6e08OOOOc850101611861OlO16iei6eOOO000e6ee" 

NeedResponse=l 

• Now open the /etc/usb_modeswitch.conf file and add the information obtained above to the file. 

• Open a terminal window and enter: 

sudo leafpad 

/ etc/usb_modeswitch . conf 

• Then add the following replacing the codes and MessageContent values with those of your device and save. 

DefaultVendor=0xl9d2 
DefaultProduct=0x2000 

TargetVendor=0xl9d2 
Target Product=0x2002 

MessageContent="5553424312345 67 8000000000000061e000000000000000000000000000000" 
MessageContent2=" 5553424312345 67 90000000000000 61b000000020000000000000000000000" 
MessageContent3=" 5553424312345 6702000000080000c85010101 180101010101000000000000" 



4. Create the wvdial config file 

• The next step is to create a config file for wvdial so you can connect to your service provider. 

• Open a terminal window and enter: 

sudo leafpad 

/ etc/wvdial .conf 



• Replace the content of the file with the following. 



[Dialer 3gconnect] 
Initl = ATZ 

Init2 = ATQO VI El S0=0 &C1 &D2 
+FCLASS=0 

InitS = AT+CGDC0NT=1, "IP", "internet" 

Stupid Mode = 1 

Modem Type = Analog Modem 

ISDN = 0 

Phone = *9 9# 

Modem = /dev/gsmmodem 

Username = { } 

Password = { } 

Baud = 460800 

• Replace internet with your service provider's APN 

• Replace the Phone number if you need to dial a different code to connect. 

• Replace Username and Password if needed. To leave the username and password as blank use { } 

5. Connect to the internet 

• To connect we need to make sure the device is in modem mode. 

• Open a terminal and enter: 

sudo usb_modeswitch -c 
/ etc/usb_modeswitch . conf 

• Then connect to the internet with: 

wvdial 
3gconnect 
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Comments 

Hi. Is there any way to 

Submitted by bogdan (not verified) on Sat, 2013-11-23 21:58 

Hi. Is there any way to forward ports (22 in my case) on a 3g usb dongle (Huawei e3131) connected to the USB of an 
RaspberyPi. I want remote access to the shell of the Raspbery. 

• reply 



If vour service provider 



Submitted by The Fan Club on Sat, 2013-11-23 23:19 

If your service provider allows your 3G USB modem a public IP you can access ssh directly with the IP. You will need 
a DDNS service like Duck DNS to point a domain name to the IP of the 3G modem as the public IP of the modem will 
change. 

• reply 

Hi, can this method be 

Submitted by Khingcat (not verified) on Tue, 2013-12-03 04:48 
Hi, can this method be applied for EVDO USB modem? Thank you. 

• reply 
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